home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 25 / AACD 25.iso / AACD / Utilities / BasiliskII / INSTALL < prev    next >
Encoding:
Text File  |  2001-05-31  |  6.1 KB  |  161 lines
  1. BASILISK II INSTALLATION INSTRUCTIONS
  2. =====================================
  3.  
  4. System Requirements
  5. -------------------
  6.  
  7. To use Basilisk II, you need either a 512K Mac Classic ROM image or a
  8. 512K or 1MB 32-bit clean Macintosh ROM image. You also need a copy of MacOS
  9. (0.x thru 7.5 for Classic emulation, 7.x or 8.0/8.1 for Mac II emulation).
  10. For copyright reasons, none of these items are included with Basilisk II.
  11. MacOS 7.5.3 and earlier versions can be downloaded from Apple and various
  12. other Internet sites. Mac ROM files are not freely available. You have to
  13. own a real Mac and read out its ROM. No, I don't know where you can download
  14. ROM files. No, I won't send you one.
  15.  
  16. Depending on the platform you use, Basilisk II has additional requirements:
  17.  
  18. BeOS:
  19.   You need BeOS R4 or better.
  20.   Basilisk II cannot do Mac Classic emulation.
  21.  
  22. Unix:
  23.   You need X11R6 and a "make" utility with the VPATH feature (e.g. GNU make).
  24.   For serial, ethernet and audio support, you need pthreads. To use the GUI
  25.   preferences editor, you also need GTK+ version 1.2 or better. On Linux, you
  26.   need glibc 2.0 or better.
  27.  
  28. AmigaOS:
  29.   You need at least a 68020 and AmigaOS 3.0 or better. To get the GUI
  30.   preferences editor, you need gtlayout.library V39 or later. To get sound
  31.   output, you need AHI V2 or later. Both items can be found on Aminet. You
  32.   also need the "PrepareEmul" utility that somes with ShapeShifter (or any
  33.   equivalent PrepareEmul substitute). The AmigaOS version of Basilisk II
  34.   cannot do Mac Classic emulation.
  35.  
  36. Windows:
  37.   You need at least Windows NT 4.0. Windows 95 and 98 can be used too, with a
  38.   somewhat reduced set of features. Basilisk II supports DirectX version 5 or
  39.   later, but version 3 may also work, depending on your graphics card.
  40.  
  41.  
  42. Installation
  43. ------------
  44.  
  45. BeOS:
  46.   If you have a binary distribution of Basilisk II for BeOS, there are
  47.   executables for BeOS/PPC and/or BeOS/x86 included. Basilisk II cannot run
  48.   concurrently with SheepShaver. Trying to do so will crash Basilisk II, or
  49.   SheepShaver, or both.
  50.  
  51.   If you have the source distribution, do the following:
  52.  
  53.     cd src/BeOS
  54.     make
  55.  
  56.   This will produce an executable "BasiliskII" in the "obj.ppc" or "obj.x86"
  57.   directory. To use Ethernet, you also have to do:
  58.  
  59.     cd SheepNet
  60.     make install
  61.  
  62.   On a PowerPC system, you also have to do:
  63.  
  64.     cd SheepDriver
  65.     make install
  66.  
  67. Unix:
  68.   To compile Basilisk II, do the following:
  69.  
  70.     cd src/Unix
  71.     ./configure
  72.     make            [or "gmake" if you have GNU make and "make" fails]
  73.     make install    [optionally]
  74.  
  75.   To use Ethernet networking under Linux, you either have to configure your
  76.   kernel for ethertap support or make and install the "sheep_net" driver:
  77.  
  78.     make modules
  79.  
  80.   This should produce a kernel module "sheep_net.o" in the "Linux/NetDriver"
  81.   directory. Now su root and say
  82.  
  83.     cd Linux/NetDriver
  84.     make dev
  85.     /sbin/insmod sheep_net.o
  86.  
  87.   This will install the device node "/dev/sheep_net" and load the driver.
  88.   You should give appropriate access rights to /dev/sheep_net if you don't
  89.   want to have to run Basilisk II as root.
  90.  
  91.   This is what Brian J. Johnson says about compiling for IRIX:
  92.    "I recommend compiling with "-Ofast".  This requires changing "-g"
  93.     to "-Ofast" in the Makefile, and adding "-ipa" to LDFLAGS.  This
  94.     turns on massive interprocedural optimization, and makes for much
  95.     better performance."
  96.  
  97.   ATTENTION NetBSD/m68k USERS:
  98.   If you want to run Basilisk II natively (i.e. without CPU emulation), you
  99.   must NOT use a pthreads library. User-level threads libraries such as PTL
  100.   interfere with the signal handlers installed by Basilisk II and kernel-
  101.   level threads are not supported by NetBSD, so you will have to live without
  102.   pthreads (and thus, without serial/ethernet/audio support).
  103.  
  104.   ATTENTION NetBSD/mac68k USERS:
  105.   Current (as of July 2000) versions of the NetBSD/mac68k kernel have a bug
  106.   that not only prevents Basilisk II from running properly but seems to even
  107.   cause kernel panics under certain conditions! Apply the following patch to
  108.   /sys/arch/mac68k/mac68k/macromasm.s, recompile and re-install the kernel
  109.   and reboot before using Basilisk II:
  110.  
  111.     --- macromasm.s.orig    Wed Jul  5 19:29:01 2000
  112.     +++ macromasm.s Wed Jul  5 19:12:34 2000
  113.     @@ -37,6 +37,8 @@
  114.  
  115.      #include "opt_adb.h"
  116.      #include "assym.h"
  117.     +#include <machine/asm.h>
  118.     +#include <machine/trap.h>
  119.  
  120.  
  121.             /* Define this symbol as global with (v) value */
  122.     @@ -437,8 +439,9 @@
  123.             movw    sp@(FR_HW + 4), d0      | retrieve status register
  124.             andw    #PSL_S, d0      | supervisor state?
  125.             bne     Lalnosup        | branch if supervisor
  126.     -       jbsr    _mrg_aline_user | user a-line trap
  127.     -       bra     Lalrts
  128.     +       addql   #4, sp          | pop frame ptr
  129.     +       movql   #T_ILLINST, d0  | user-mode fault
  130.     +       jra     _ASM_LABEL(fault)
  131.      Lalnosup:
  132.      #define FR_PC (FR_HW+2)
  133.             movl    sp@(FR_PC + 4), a0      | retrieve PC
  134.  
  135. AmigaOS:
  136.   If you have a binary distribution of Basilisk II for AmigaOS, there is an
  137.   executable included. You must also have the "PrepareEmul" utility installed
  138.   that comes with ShapeShifter (or any equivalent PrepareEmul substitute,
  139.   see the ShapeShifter docs). If you have the source distribution, do the
  140.   following:
  141.  
  142.     cd src/AmigaOS
  143.     make
  144.  
  145.   To recompile Basilisk II, you need the GeekGadgets development suite and
  146.   PhxAss (which can be found on Aminet).
  147.  
  148. Windows NT:
  149.   If you have a binary distribution of Basilisk II for Windows, there is a
  150.   Windows NT binary included. To access CD-ROMs under Windows NT, the driver
  151.   "cdenable.sys" must be copied to your "\WinNT\System32\drivers" directory.
  152.   To access CD-ROMs under Windows 9x, the driver "cdenable.vxd" must be copied
  153.   to the "\Windows\System" directory. To recompile Basilisk II, you need
  154.   MS Visual V++ 5.0 or later. Symantec C++ should work, too, with some
  155.   modifications. See the "sysdeps.h" file in the "Windows" directory.
  156.  
  157. The ROM file has to be named "ROM" and put in the same directory as the
  158. Basilisk II executable but you can specify a different location for the ROM
  159. file with the "rom" option in the preferences file (or with the preferences
  160. GUI).
  161.